Licensing Servers

Prerequisites

• Access Level: Admin, Super-admin.
• Permission Requirements:
• . Basic VM Interaction
  • View drives (inconsistent, see notes)
  • Edit drives (name and whether to disable backup)
  • View drive keys (necessary to share/attach)
  • Share drives
  • Unshare drives
  • Attach drives to VMs
  • Detach drives from VMs
  • View hardware/image setups made available to them
  • View own VM configs and configs shared with them
  • Create (and edit) VM configs
  • View own VM username
  • View anyone's VM username (necessary for sharing VMs)
  • Create sub-session for VM->Vault direct transfer
  • View own VMs and VMs shared with them
  • Connect to own VMs and VMs shared with them
  • View storage pools for any Libvirt realm
  • Lookup individual Libvirt storage pools
• . VM Administration
  • View all VM configs in the system
  • Arbitrarily edit any VM config
  • View external servers
  • Create external servers
  • Edit external servers
  • Delete any licensing server
  • Arbitrarily view logs from any VM
• . Miscellaneous
  • Transfer ownership of own files and drives

Access the Licensing Servers in the Management

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the Licensing Servers in the left panel.
4. In the list, view the existing licensing servers' name, ports, protocol, active status, group, deactivation, creator and creation date.

View the Basic Information of a Licensing Server

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the Licensing Servers in the left panel.
4. Select the licensing server to view basic information.
5. Click the View button in the top right panel.
6. In the left panel, under Basic Info subsection, view the licensing server, ports, owner, group and creation date.

Create a New Licensing Server

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the Licensing Servers in the left panel.
4. Click the Create new licensing server button in the top right panel.
5. In the pop-up, enter the server domain or IPv4 address.
6. Click the Add button next to add them.
7. Enter the optional ports between 1 and 65,535.
8. Under Protocol, select TCP (Transmission Control Protocol) or UDP (User Datagram Protocol).
9. Under Group (optional), enter the group from the list associated with the licensing server.
10. Under Deactivate On (optional), specify the licensing server expiration date.
11. Click Register new servers.

note

• Use TCP for reliability over speed; it is slower but more reliable, making it suitable for critical license transactions.
• Use UDP for speed over delivery, faster but might lose data, for lightweight license updates.
• Groups in licensing servers are simple metadata tags that assist with resource management.
• The expiration date helps manage licenses and prevents work disruptions caused by expired software.

tip

You should use both TCP and UDP for maximum efficiency.

Re-Sync Rules in a Licensing Server

bulk-action

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the Licensing Servers in the left panel.
4. Click the Re-sync Rules button in the top right panel.

Refresh View of a Licensing Server

bulk-action

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the Licensing Servers in the left panel.
4. Click the Refresh button in the top right panel.

Delete an Existing Licensing Server

bulk-action

1. Go to the Management icon in the top left taskbar.
2. Navigate to the Virtual Machines section.
3. Click the Licensing Servers in the left panel.
4. Select the licensing server(s) to delete.
5. Click the Delete button in the top right corner.
6. In the prompt, click Delete licensing servers.

danger

Deleting a licensing server will permanently revoke your access to it.